home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 26
/
Cream of the Crop 26.iso
/
bbs
/
arp206.zip
/
ARP.DOC
next >
Wrap
Text File
|
1997-07-16
|
14KB
|
397 lines
------------------------------ 16. July 1997
Adept Request Prozessor ARP
------------------------------
Version 2.06
Topics:
What is the Adept Request Prozessor ...................... I
Warranty ................................................. II
Copyright information .................................... III
Before installation ...................................... IV
How to install Adept Request Prozessor ................... V
How to run Adept Request Prozessor ....................... VI
Troubleshooting .......................................... VII
Registration ............................................. VIII
How to contact the Author ................................ IX
I - What is the Adept Request Prozessor?
----------------------------------------
The ARP is a small utility to answer fts styled file frequests.
ARP reads out all frequests, compares your magics contained in your
ok files and builds a frequest response message.
The following is an example of a frequest response message.
The first two files are frequested using magic files and ADEPT, the third is
automaticly send by ARP:
[only comments!]
-------------- < EXAMPLE > -------------
[header file]
┌────────────────────────────────────────────────────────────────────────────┐
▄▄▄ ▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄ ▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄
█ █ █ █ █ ▄▄▄▄█ █ ▄▄▄ ██ ▄▄▄ █ █ █ █ ▄▄▄ █ █ ▀██ █ █ ▄▄▄▄█ █▄▄ ▄▄█ █ ▄▄▄▄█
█▄▀█▀▄█ █ █▄▄ █ █ ▄▄▄ ██ ▄▄▄▄█ █ █▄▄▄▄ █ ▄▄▄ █ █ █▄▀ █ █ ▄▄▄█▄ █ █ █▄▄▄▄ █
│▀█▄█▀ █▄▄▄▄▄█ █▄█ █▄██▄█ █▄▄▄▄▄█ █▄█ █▄█ █▄█▀█▄█ █▄▄▄▄▄█ █▄█ █▄▄▄▄▄█
│ ▄▄▄▄▄▄ ▄▄▄▄▄▄▄ ▄▄▄ ▄▄▄ │
│ Sysop: Klaus Ader █ ▄▄ █▄ █ ▄▄▄ █ █▄▀█▀▄█ 0201-898524 ISDN + V34 │
│ Limits: your own bill █ ▄▄▄ █ █ █▄█ █ ▄█▀▄▀█▄ 0201-898598 ISDN │
│ █▄▄▄▄▄█ █▄▄▄▄▄█ █▄█▀█▄█ außer ZMH │
└────────────────────────────────────────────────────────────────────────────┘
[frequest response]
let's talk about your frequest at
my bulletin board system:
You are connected to line 1
Session type: Password protected mailer session
══════════════════════════════════════════════════════════════════════════════
Dateiname Groesse Datum Beschreibung
──────────── ─────── ──────── ─────────────────────────────────────
ALL391.ZIP 250010 18/08/96 Komplette Fileliste der
VGA-PLANETS-BOX
V34 0201-898524 ISDN
0201-898598 ISDN
Frequested via magic: FILES
Dateiname Groesse Datum Beschreibung
──────────── ─────── ──────── ─────────────────────────────────────
BULLSHIT Could not find this file!!!
If your syntax is correctly,
PLEASE report!
Dateiname Groesse Datum Beschreibung
──────────── ─────── ──────── ─────────────────────────────────────
ADPT107F.ZIP 1865121 23/04/96 AdeptXBBS v1.07f !Freeware!
AdeptXBBS 32-bit OS/2 multi-user,
multi-threaded, multi-line, PM BBS
for OS/2 v2.x, and Warp.
AdeptXBBS requires HPFS, and will
not install on a FAT based drive.
AdeptXBBS includes and full BBS, a
Fidonet Capable Mailer, and Fidonet
message base utilities.
This is BOTH a Upgrade and a
FULL INSTALL.
Frequested via magic: ADEPT
Dateiname Groesse Datum Beschreibung
──────────── ─────── ──────── ─────────────────────────────────────
AD-NET.ZIP 866 16/06/96 ┌────────────────────────────┐
│Nodeantrag fuer das AdeptNet│
│============================│
│ │
│Bitte ausfuellen und zurueck│
│schicken. Postwendend kommt │
│Deine AdeptNet AKA! │
│ │
└──────═══ by BK'96 ══───────┘
Frequested via magic: Automatic Send
══════════════════════════════════════════════════════════════════════════════
--=== Breakdown ===--
Your frequest at VGA-PLANETS-BOX
Total 2115.99kB in 4 Files
----- ========= -----
▄▄▄· ▄▄▄ ▄▄▄·
▐█ ▀█ ▀▄ █· ▐█ ▄█
▄█▀▀█ ▐▀▀▄ ██▀·
▐█ ■▐▌ ▐█∙█▌ ▐█■·∙
▀ ▀ .▀ ▀ .▀
Version 2.06
16. July 1997
Registered Version for
BK - 2:2448/391.0
Home of Adept's Request Prozessor
VGA - PLANETS - BOX
2:2448/391.0@FidoNet
(C) by BK '97
[footer file]
==========================================================================
VGA-PLANETS-BOX MAGICS
==========================================================================
Files Kompl. Fileliste
ALLINF Kompl. Fileliste in OS2 INF Version
Adeptlist Fileliste Adept tools / progs
AdeptInf Adept tools in OS2 INF Version
NewFiles Neue Files der letzten 14 Tage
VPLLIST VGA-PLANETS-Tools Fileliste
VPLINF VGA-PLANETS-Tools Fileliste in OS2 INF Version
ADEPT neuste Version von AdeptXBBS
T4UPLS neueste Version von "Tasks 4 U Plus" / DOS
Adeptmail AdeptMail V0.99wb PM-based mail reader fuer Adept
Adapt Adept MSG Base Management Tool - Try It
-------------- < EXAMPLE > -------------
II - Warranty
-------------
What is that? Never heard before!
There is only a guarantee that this file uses space on your harddrive.
III - Copyright Information
---------------------------
AdeptSoft and AdeptXBBS are registered trademarks of AdeptSoft.
XBBS copyright (c) 1988 - 1994 by M. Kimes.
The XBBS name is a trademark of M. Kimes.
VX-REXX is a trademark of Watcom
ReqRob is (c) by S.Homburg
IV - Before Installation
------------------------
You must VROBJ.DLL in your libpath! Version 2.14, 1.09.1995
Check your Adept Setup:
Config -> Active line -> mailer settings
Mail Proc.CMD: Cmd.Exe /c Mail.Cmd 1 %s
1 indicates your line
%s is an arg line parameter, indicates your actual inbound path
so if you 're running a multiline system, your second line should look like
Cmd.Exe /c Mail.Cmd 2 %s
Cmd.Exe /c Mail.Cmd 3 %s
Cmd.Exe /c Mail.Cmd 4 %s etc.
V - How to Install ARP
----------------------
Very simple:
1.Step
Unzip the archive in any directory you want
and run:
ARP200.EXE Setup
and follow the instructions on your screen.
You also can manually edit ARP2.INI:
1. line: your Adept path
2. line: header for your answers
3. line: footer
4. line: send this file on every frquest (ex. AdeptNet.ZIP) Leave this line blank if
you do not want to send a file automaticly on any freq!
5. line: Name of Your BBS
6. line: Path to your ok-files
7. line: 1=add download counters
8. line: 1=add free file fino
Example:
========
C:\ADEPT\
C:\ADEPT\tools\arp2\HEADER.TXT
C:\ADEPT\tools\arp2\FOOTER.TXT
AD-NET.ZIP
VGA-PLANETS-BOX
C:\ADEPT\MAILER\
1
1
2.Step
Edit your MAIL.CMD. Normal mail.cmd should look like:
---------------- <cut> ---------------------------
rem ======================================
rem ----ARP:
rem ======================================
cd \adept\tools\arp2
arp200.exe %1 %2
rem ======================================
rem ----File Ticer:
rem ======================================
cd \adept
yaticp.exe
rem ======================================
rem ----Matrix Mailing
rem ======================================
cd \adept\tools\yabom
yabomp matrix
rem ======================================
rem ----Mail Tosser:
rem ======================================
cd \adept
Gatekpr.Exe GateKpr.Ctl A HP
---------------- <cut> ---------------------------
If you are using a rexx script use example below.
/* Adept mail.cmd via REXX */
/* ================ ARP ========================= */
parse arg line inbound
'c:\adept\tools\arp2\arp200.exe 'line inbound
/* =============Yatic + Yabom =================== */
'CD \ADEPT'
'YATICP.EXE'
'cd \adept\tools\yabom'
'YABOMP.EXE MATRIX'
'cd \adept'
'GateKpr.Exe GateKpr.Ctl A HP'
exit
/* End. */
Advanced Setup using Koen's mail.cmd:
/*****************************************************************************/
/* Mail.Cmd v1.1 with recycle options by Koen Koster alias CliP on IRC */
/*****************************************************************************/
/* This Mail.Cmd will recycle multiple gatekeeper tasks so that only 1 */
/* GateKeeper task is started which will handle all GK requests :-) */
/*****************************************************************************/
/******************* < Begin Sysop Configuration Section > *******************/
AdeptDirectory = 'c:\adept' /* change drive */
BusyFlag = 'c:\adept\gatekpr.busy' /* change drive */
RunningFlag = 'c:\adept\gatekpr.running' /* change drive */
/******************** < End Sysop Configuration Section > ********************/
call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysloadFuncs'
call SysLoadFuncs
curDir = Directory(AdeptDirectory)
call RxFuncAdd 'SysFileTree','RexxUtil','SysFileTree'
rc = SysFileTree(RunningFlag,"stem",'F')
/* ================ ARP ========================= */
parse arg line inbound
call 'drive:\anypathyouwant\arp.exe' line inbound
NOT tested on my system !!!
3. Step
Now you should edit the header and footer file as you want
Do not use more than 78 chars per line!
That's all you have to do!
VI - How to run Adept Request Prozessor
---------------------------------------
See chapter V above for examples, how to run ARP in your adept configs.
VII - Troubleshooting
---------------------
I have tested ARP (Version I & II) for a long time without getting into any trouble.
Arp has its own error handling. If any error occures a file called
arp200.err will be created. Please send back this file !!!
Up now Adept doesn't update downloadcounters, so it is a bit boring
to add the download counter [000] to all frequested files.
As soon as this function will be used I will add the counters.
Also the freefile tag seems to be useless.
Another strange bug of AdeptXBBS:
Adept sends 'Badfreq.TXT' as often as it couldn't find a frequested file.
This bug will be the reason, when ARP's response mail is send more than once!
What is ARP doing?
On a filerequest your inbound directory will contain a file called *.REQ,
which is a plain ascii file.
I add a line to this file like 'Your_frequest_at_VGA-PLANETS-BOX'
Adept will interpret this line as a filename, which doesn't exist.
BADFREQ.TXT is send automatically to the frequester. Editing badfreq.txt
is all I have to do, but ... JUST IN TIME!
If your .OK files are 5-liners, your filebase holds about 10 files
there will be not enough time to edit all files while adept is working
on the filerequest!
If you have 5-liners or a filebase containing 10 files, you do not need
my program! Send an allfiles list to everyone frequesting files at your
BBS!
VIII - Registration:
--------------------
You may registrate your copy of ARP.
Simply send a postcard to
Klaus Ader
Steeler Str 286
45138 Essen
Germany
IX - How to contact the author
------------------------------
You may contact me via:
Internet : Email to klaus.ader@rz.ruhr-uni-bochum.de
Fidonet : 2:2448/391.0@fidonet | 55:62/0.0@adeptnet
BBS : VGA - PLANETS - BOX
0049 201 - 898524 │ 0049 201-898598
V34 + ISDN │ ISDN
***********************************************************
see ya
BK